home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / dosmax21.zip / STOPMAX.DOC < prev    next >
Text File  |  1993-06-01  |  14KB  |  332 lines
  1.  
  2. ================================================================================
  3.        STOPMAX.SYS :  Ver. 2.1, Copyright (1992,93) by Philip B. Gardner
  4. ================================================================================
  5.  
  6.   STOPMAX.SYS is a derivative of DOSMAX.EXE.  The algorithums of DOSMAX which
  7.   "stop" the DOS 5.0 and above kernel from loading into the HMA have been
  8.   assembled separately into STOPMAX.SYS.  This allows DOSMAX.EXE to load high
  9.   after the memory manager has installed and still put the DOS kernel into a
  10.   UMB.  STOPMAX is specifically for DOS 5.0 and above users and will not work
  11.   with DOS versions prior to DOS 5.0 and above.
  12.  
  13.   STOPMAX prevents DOS from loading into the HMA using one of the for methods
  14.   which are also part of DOSMAX.  The default method "/B," patches the DOS
  15.   5.0 and above initialization code.  This method and the "/V" (VDISK header
  16.   method), do not require any resident memory, so STOPMAX simply executes and
  17.   returns all memory to DOS.  DOSMAX should then be loaded as a DEVICE, after
  18.   the memory manager and there is no restriction as to when DOSMAX should be
  19.   installed.
  20.  
  21.   Support is provided for:
  22.  
  23.         * Stopping DOS from loading into the HMA
  24.  
  25. ================================================================================
  26.  
  27. (Requirements)::
  28.  
  29.         * Requires MS-DOS Version 5.00 or above
  30.  
  31. ================================================================================
  32.  
  33. (Installation)::
  34.  
  35.         (CONFIG.SYS)::
  36.  
  37.         Installation of STOPMAX.SYS requires modifying the contents of
  38.         your CONFIG.SYS file.
  39.  
  40. (Generic Configuration)::
  41.  
  42.         This configuration should work and be the most efficient in 95%
  43.         of all configurations.  For a few real world examples see
  44.         EXAMPLES.DOC
  45.  
  46.         DOS=HIGH[,UMB]                    (DOS 5.0 and above only)
  47.         DEVICE=STOPMAX.SYS [options]      (Stops kernel from loading in HMA)
  48.         DEVICE=(xms/umb memory manager)
  49.         DEVICE=DOSMAX.EXE [options]       (DOSMAX loads high automatically)
  50.         SHELL=SHELLMAX.COM COMMAND.COM /P
  51.         BUFFERS=20
  52.         FILES=40
  53.         LASTDRIVE=Z
  54.  
  55.         DOS 5.0 and above users should configure DOS to load high into
  56.         the HMA.  The UMB parameter is optional, since both DOS 5.0 and
  57.         above upper memory management and XMS upper memory blocks are
  58.         supported by DOSMAX.
  59.  
  60.         DOS=HIGH[,[UMB][NOUMB]] (Both DOS UMB's and XMS UMB's supported)
  61.  
  62.         Add a DEVICE= line for STOPMAX.SYS in your config.sys.  STOPMAX
  63.         must be loaded before the XMS and UMB memory manager, but some
  64.         memory managers provide high memory but not an HMA.  If your
  65.         memory manager does not support an HMA, then STOPMAX is not
  66.         necessary.  DOSMAX is then loaded "after" the memory manager
  67.  
  68.         HIMEM.SYS from Microsoft always puts the DOS 5.0 and above kernel
  69.         into the HMA before it is through initializing and then puts its
  70.         own code into the HMA.  If you are able to load HIMEM.SYS high
  71.         (using some upper memory providers, not EMM386.SYS), you can now
  72.         use the /I+ switch to stop HIMEM from loading DOS into the HMA,
  73.         and STOPMAX will put it into a UMB instead.  The /B+ option (default)
  74.         also stops HIMEM.SYS from putting the DOS kernel into the HMA.  If
  75.         you use only DOS 5.0 and above files, meaning HIMEM.SYS and EMM386.SYS
  76.         you should not use STOPMAX.
  77.  
  78.         DEVICE=STOPMAX.SYS [options]
  79.         DEVICE=(Memory Manager)
  80.         ......
  81.         DEVICE=DOSMAX.EXE [options]
  82.  
  83.         By default, STOPMAX.SYS will generate a message for each successful
  84.         operation or event.  The display then pauses to allow you to
  85.         read the report.  After you are satisfied with the configuration
  86.         and you want to disable the REPORT and PAUSE feature, use:
  87.  
  88.         DEVICE=STOPMAX.SYS /R- /P- 
  89.  
  90.         All switch options and possible messages for STOPMAX are detailed
  91.         below:
  92.  
  93. ================================================================================
  94.  
  95. (Syntax)::
  96.  
  97.         The only thing to remember about syntax for the command line is
  98.         that just about anything works.  What this means is that you
  99.         should be able to type in the options on the command line the
  100.         way they make sense to you.
  101.  
  102.         To illustrate this point, the following command line example
  103.         is mutated several different ways.
  104.  
  105.         DEVICE=STOPMAX.SYS /R- /P- /B+
  106.         DEVICE=STOPMAX.SYS -R- -P- -B+
  107.         DEVICE=STOPMAX.SYS R- P- B+
  108.         DEVICE=STOPMAX.SYS R-P-B
  109.         DEVICE=STOPMAX.SYS -R-P-B
  110.  
  111.         ... and so on.
  112.  
  113.         STOPMAX 1.9 and above adds optional full word syntax.  The new
  114.         syntax looks like this:
  115.  
  116.         DEVICE=STOPMAX.SYS /REPORT:- /PAUSE:- /IOPATCH:+
  117.         DEVICE=STOPMAX.SYS -REPORT:- -PAUSE:- -IOPATCH:+
  118.         DEVICE=STOPMAX.SYS REPORT:- PAUSE:- IOPATCH:+
  119.         DEVICE=STOPMAX.SYS REPORT-PAUSE-IOPATCH:+
  120.         DEVICE=STOPMAX.SYS -REPORT-PAUSE-IOPATCH:+
  121.  
  122.         Obviously when using full words, it is easier to keep the words
  123.         separated so that is clear to read.  The optional [:] is used
  124.         for toggle switches (i.e. REPORT:+).  These optional delimiters
  125.         can also be used with the single letter switches.  Exact spelling
  126.         is required because the single letter interface is still intact.
  127.  
  128. (Switch Options)::
  129.  
  130.         The following list of switch options is organized by:
  131.  
  132.           - Control of STOPMAX Reports (/R:/P:/N:)
  133.           - Control the Location of the DOS Kernel (/B:/V:/I:)
  134.  
  135.     (Control of STOPMAX Reports)::
  136.  
  137.         (REPORT)::      R[+ or -]        (toggle:  default +)
  138.  
  139.         Use /R- or /REPORT:- to disable the report after you are
  140.         satisfied with the configuration of STOPMAX.SYS
  141.  
  142.         (PAUSE)::       P[+ or -]        (toggle:  default +)
  143.  
  144.         Use /P- or /PAUSE:- to disable the pause after the report as
  145.         long as there are no errors or warnings.
  146.  
  147.         (NOPAUSE)::     N[+ or -]        (toggle:  default -)
  148.  
  149.         Use /N+ or /NOPAUSE:+ to never pause after the report, even if
  150.         there are errors.  This switch can be used if your configuration
  151.         generates a warning or error message which you choose to ignore.
  152.  
  153.     (Control the Location of the DOS Kernel)::
  154.  
  155.         (IOPATCH)::     B[+ or -]        (toggle:  default -)
  156.  
  157.         Use /B+ or /IOPATCH:+ to stop DOS from loading in the HMA using
  158.         a method which patches the copy of DOS 5.0 initialization code in
  159.         memory when STOPMAX initializes.  This method will search and
  160.         "patch out" the DOS to HMA code.  This option was developed and
  161.         tested under MSDOS 5.0 and 6.0 and is not guaranteed to work with
  162.         DOS versions later than 6.0, but then many of the algorithums in
  163.         STOPMAX depend upon "undocumented" features of DOS which are always
  164.         subject to change anyway.  The advantage of this method is that it
  165.         works no matter which memory manager is used or how it is configured.
  166.  
  167.         (VDISK)::       V[+ or -]        (toggle:  default -)
  168.  
  169.         Use /V+ or /VDISK:+ to enable an alternate method of stopping
  170.         DOS from allocating the HMA.  This switch is only necessary
  171.         if STOPMAX reports that the DOS version is incompatible, and
  172.         it will only work with memory managers which can detect a
  173.         VDISK Header in the HMA when the memory manager initializes
  174.         and mark's it as allocated.
  175.  
  176.         (STOPHIMEM)::   I[+ or -]        (toggle:  default -)
  177.  
  178.         Use /I+ or /STOPHIMEM:+ to stop HIMEM.SYS from loading DOS HIGH.
  179.         This switch is intended for users who load HIMEM.SYS from
  180.         Microsoft high after their UMB provider.  This option is not
  181.         very useful if HIMEM.SYS is not loaded high because HIMEM will
  182.         grow to about 30k in size.  If you still want to inhibit HIMEM,
  183.         then load it last, to minimize the "growth."  The reason HIMEM
  184.         "grows" is because the code which normal